<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>closest_point_transform [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_regions.html">区域</a> / <a href="toc_regions_transformations.html">变换</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">closest_point_transform</span><span data-if="c" style="display:none;">closest_point_transform</span><span data-if="cpp" style="display:none;">ClosestPointTransform</span><span data-if="dotnet" style="display:none;">ClosestPointTransform</span><span data-if="python" style="display:none;">closest_point_transform</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">closest_point_transform</span><span data-if="c" style="display:none;">closest_point_transform</span><span data-if="cpp" style="display:none;">ClosestPointTransform</span><span data-if="dotnet" style="display:none;">ClosestPointTransform</span><span data-if="python" style="display:none;">closest_point_transform</span></code> — Compute the closest-point transformation of a region.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>closest_point_transform</b>(<a href="#Region"><i>区域</i></a> : <a href="#Distances"><i>Distances</i></a>, <a href="#ClosestPoints"><i>ClosestPoints</i></a> : <a href="#Metric"><i>Metric</i></a>, <a href="#Foreground"><i>Foreground</i></a>, <a href="#ClosestPointMode"><i>ClosestPointMode</i></a>, <a href="#Width"><i>Width</i></a>, <a href="#Height"><i>Height</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>closest_point_transform</b>(const Hobject <a href="#Region"><i>区域</i></a>, Hobject* <a href="#Distances"><i>Distances</i></a>, Hobject* <a href="#ClosestPoints"><i>ClosestPoints</i></a>, const char* <a href="#Metric"><i>Metric</i></a>, const char* <a href="#Foreground"><i>Foreground</i></a>, const char* <a href="#ClosestPointMode"><i>ClosestPointMode</i></a>, const Hlong <a href="#Width"><i>Width</i></a>, const Hlong <a href="#Height"><i>Height</i></a>)</code></p>
<p>
<code>Herror <b>T_closest_point_transform</b>(const Hobject <a href="#Region"><i>区域</i></a>, Hobject* <a href="#Distances"><i>Distances</i></a>, Hobject* <a href="#ClosestPoints"><i>ClosestPoints</i></a>, const Htuple <a href="#Metric"><i>Metric</i></a>, const Htuple <a href="#Foreground"><i>Foreground</i></a>, const Htuple <a href="#ClosestPointMode"><i>ClosestPointMode</i></a>, const Htuple <a href="#Width"><i>Width</i></a>, const Htuple <a href="#Height"><i>Height</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>ClosestPointTransform</b>(const HObject&amp; <a href="#Region"><i>区域</i></a>, HObject* <a href="#Distances"><i>Distances</i></a>, HObject* <a href="#ClosestPoints"><i>ClosestPoints</i></a>, const HTuple&amp; <a href="#Metric"><i>Metric</i></a>, const HTuple&amp; <a href="#Foreground"><i>Foreground</i></a>, const HTuple&amp; <a href="#ClosestPointMode"><i>ClosestPointMode</i></a>, const HTuple&amp; <a href="#Width"><i>Width</i></a>, const HTuple&amp; <a href="#Height"><i>Height</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HRegion.html">HRegion</a>::<b>ClosestPointTransform</b>(HImage* <a href="#ClosestPoints"><i>ClosestPoints</i></a>, const HString&amp; <a href="#Metric"><i>Metric</i></a>, const HString&amp; <a href="#Foreground"><i>Foreground</i></a>, const HString&amp; <a href="#ClosestPointMode"><i>ClosestPointMode</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HRegion.html">HRegion</a>::<b>ClosestPointTransform</b>(HImage* <a href="#ClosestPoints"><i>ClosestPoints</i></a>, const char* <a href="#Metric"><i>Metric</i></a>, const char* <a href="#Foreground"><i>Foreground</i></a>, const char* <a href="#ClosestPointMode"><i>ClosestPointMode</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HRegion.html">HRegion</a>::<b>ClosestPointTransform</b>(HImage* <a href="#ClosestPoints"><i>ClosestPoints</i></a>, const wchar_t* <a href="#Metric"><i>Metric</i></a>, const wchar_t* <a href="#Foreground"><i>Foreground</i></a>, const wchar_t* <a href="#ClosestPointMode"><i>ClosestPointMode</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>ClosestPointTransform</b>(<a href="HObject.html">HObject</a> <a href="#Region"><i>区域</i></a>, out <a href="HObject.html">HObject</a> <a href="#Distances"><i>distances</i></a>, out <a href="HObject.html">HObject</a> <a href="#ClosestPoints"><i>closestPoints</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Metric"><i>metric</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Foreground"><i>foreground</i></a>, <a href="HTuple.html">HTuple</a> <a href="#ClosestPointMode"><i>closestPointMode</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Width"><i>width</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Height"><i>height</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HRegion.html">HRegion</a>.<b>ClosestPointTransform</b>(out <a href="HImage.html">HImage</a> <a href="#ClosestPoints"><i>closestPoints</i></a>, string <a href="#Metric"><i>metric</i></a>, string <a href="#Foreground"><i>foreground</i></a>, string <a href="#ClosestPointMode"><i>closestPointMode</i></a>, int <a href="#Width"><i>width</i></a>, int <a href="#Height"><i>height</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>closest_point_transform</b>(<a href="#Region"><i>区域</i></a>: HObject, <a href="#Metric"><i>metric</i></a>: str, <a href="#Foreground"><i>foreground</i></a>: str, <a href="#ClosestPointMode"><i>closest_point_mode</i></a>: str, <a href="#Width"><i>width</i></a>: int, <a href="#Height"><i>height</i></a>: int) -&gt; Tuple[HObject, HObject]</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">closest_point_transform</span><span data-if="c" style="display:none">closest_point_transform</span><span data-if="cpp" style="display:none">ClosestPointTransform</span><span data-if="com" style="display:none">ClosestPointTransform</span><span data-if="dotnet" style="display:none">ClosestPointTransform</span><span data-if="python" style="display:none">closest_point_transform</span></code> computes for every pixel of the
input region <a href="#Region"><i><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></i></a> (or its complement, respectively) the
distance to the closest pixel outside the region (i.e., to the pixel
on the outside border of the region) and returns this information in
<a href="#Distances"><i><code><span data-if="hdevelop" style="display:inline">Distances</span><span data-if="c" style="display:none">Distances</span><span data-if="cpp" style="display:none">Distances</span><span data-if="com" style="display:none">Distances</span><span data-if="dotnet" style="display:none">distances</span><span data-if="python" style="display:none">distances</span></code></i></a>.  In addition to the distance, the corresponding
closest pixel is returned in <a href="#ClosestPoints"><i><code><span data-if="hdevelop" style="display:inline">ClosestPoints</span><span data-if="c" style="display:none">ClosestPoints</span><span data-if="cpp" style="display:none">ClosestPoints</span><span data-if="com" style="display:none">ClosestPoints</span><span data-if="dotnet" style="display:none">closestPoints</span><span data-if="python" style="display:none">closest_points</span></code></i></a>.
</p>
<p>The parameter <a href="#Foreground"><i><code><span data-if="hdevelop" style="display:inline">Foreground</span><span data-if="c" style="display:none">Foreground</span><span data-if="cpp" style="display:none">Foreground</span><span data-if="com" style="display:none">Foreground</span><span data-if="dotnet" style="display:none">foreground</span><span data-if="python" style="display:none">foreground</span></code></i></a> determines whether the distances
are calculated for all points within the region (<a href="#Foreground"><i><code><span data-if="hdevelop" style="display:inline">Foreground</span><span data-if="c" style="display:none">Foreground</span><span data-if="cpp" style="display:none">Foreground</span><span data-if="com" style="display:none">Foreground</span><span data-if="dotnet" style="display:none">foreground</span><span data-if="python" style="display:none">foreground</span></code></i></a>
= <i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i>) or for all points outside the region
(<a href="#Foreground"><i><code><span data-if="hdevelop" style="display:inline">Foreground</span><span data-if="c" style="display:none">Foreground</span><span data-if="cpp" style="display:none">Foreground</span><span data-if="com" style="display:none">Foreground</span><span data-if="dotnet" style="display:none">foreground</span><span data-if="python" style="display:none">foreground</span></code></i></a> = <i><span data-if="hdevelop" style="display:inline">'false'</span><span data-if="c" style="display:none">"false"</span><span data-if="cpp" style="display:none">"false"</span><span data-if="com" style="display:none">"false"</span><span data-if="dotnet" style="display:none">"false"</span><span data-if="python" style="display:none">"false"</span></i>).  The distance is computed
for every pixel of the output images <a href="#Distances"><i><code><span data-if="hdevelop" style="display:inline">Distances</span><span data-if="c" style="display:none">Distances</span><span data-if="cpp" style="display:none">Distances</span><span data-if="com" style="display:none">Distances</span><span data-if="dotnet" style="display:none">distances</span><span data-if="python" style="display:none">distances</span></code></i></a> and
<a href="#ClosestPoints"><i><code><span data-if="hdevelop" style="display:inline">ClosestPoints</span><span data-if="c" style="display:none">ClosestPoints</span><span data-if="cpp" style="display:none">ClosestPoints</span><span data-if="com" style="display:none">ClosestPoints</span><span data-if="dotnet" style="display:none">closestPoints</span><span data-if="python" style="display:none">closest_points</span></code></i></a>.  The size of the images is specified by
<a href="#Width"><i><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></i></a> and <a href="#Height"><i><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></i></a>.  The input region is always
clipped to the extent of the output image.  If it is important that
the distances within the entire region should be computed, the
region should be moved (see <a href="move_region.html"><code><span data-if="hdevelop" style="display:inline">move_region</span><span data-if="c" style="display:none">move_region</span><span data-if="cpp" style="display:none">MoveRegion</span><span data-if="com" style="display:none">MoveRegion</span><span data-if="dotnet" style="display:none">MoveRegion</span><span data-if="python" style="display:none">move_region</span></code></a>) so that it has only
positive coordinates and the width and height of the output image
should be large enough to contain the region.  The extent of the
input region can be obtained with <a href="smallest_rectangle1.html"><code><span data-if="hdevelop" style="display:inline">smallest_rectangle1</span><span data-if="c" style="display:none">smallest_rectangle1</span><span data-if="cpp" style="display:none">SmallestRectangle1</span><span data-if="com" style="display:none">SmallestRectangle1</span><span data-if="dotnet" style="display:none">SmallestRectangle1</span><span data-if="python" style="display:none">smallest_rectangle1</span></code></a>.
</p>
<p>The parameter <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> determines which metric is used for
the calculation of the distances.  If <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'city-block'</span><span data-if="c" style="display:none">"city-block"</span><span data-if="cpp" style="display:none">"city-block"</span><span data-if="com" style="display:none">"city-block"</span><span data-if="dotnet" style="display:none">"city-block"</span><span data-if="python" style="display:none">"city-block"</span></i>, the distance is calculated from the shortest
path from the point to the border of the region, where only
horizontal and vertical “movements” are allowed.  They are
weighted with a weight of 1.  If <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'chessboard'</span><span data-if="c" style="display:none">"chessboard"</span><span data-if="cpp" style="display:none">"chessboard"</span><span data-if="com" style="display:none">"chessboard"</span><span data-if="dotnet" style="display:none">"chessboard"</span><span data-if="python" style="display:none">"chessboard"</span></i>, the distance is calculated from the shortest
path to the border, where horizontal, vertical, and diagonal
“movements” are allowed.  They are weighted with a weight of 1.
If <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> = <i><span data-if="hdevelop" style="display:inline">'octagonal'</span><span data-if="c" style="display:none">"octagonal"</span><span data-if="cpp" style="display:none">"octagonal"</span><span data-if="com" style="display:none">"octagonal"</span><span data-if="dotnet" style="display:none">"octagonal"</span><span data-if="python" style="display:none">"octagonal"</span></i>, a combination of these
approaches is used, which leads to diagonal paths receiving a higher
weight.  If <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> = <i><span data-if="hdevelop" style="display:inline">'chamfer-3-4'</span><span data-if="c" style="display:none">"chamfer-3-4"</span><span data-if="cpp" style="display:none">"chamfer-3-4"</span><span data-if="com" style="display:none">"chamfer-3-4"</span><span data-if="dotnet" style="display:none">"chamfer-3-4"</span><span data-if="python" style="display:none">"chamfer-3-4"</span></i>, horizontal and
vertical movements are weighted with a weight of 3, while diagonal
movements are weighted with a weight of 4.  To normalize the
distances, the resulting distance image is divided by 3.  Since this
normalization step takes some time, and one usually is interested in
the relative distances of the points, the normalization can be
suppressed with <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'chamfer-3-4-unnormalized'</span><span data-if="c" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="cpp" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="com" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="dotnet" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="python" style="display:none">"chamfer-3-4-unnormalized"</span></i>.  Finally, if <a href="#Metric"><i><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'euclidean'</span><span data-if="c" style="display:none">"euclidean"</span><span data-if="cpp" style="display:none">"euclidean"</span><span data-if="com" style="display:none">"euclidean"</span><span data-if="dotnet" style="display:none">"euclidean"</span><span data-if="python" style="display:none">"euclidean"</span></i>, the computed distance is approximately
Euclidean.
</p>
<p>The parameter <a href="#ClosestPointMode"><i><code><span data-if="hdevelop" style="display:inline">ClosestPointMode</span><span data-if="c" style="display:none">ClosestPointMode</span><span data-if="cpp" style="display:none">ClosestPointMode</span><span data-if="com" style="display:none">ClosestPointMode</span><span data-if="dotnet" style="display:none">closestPointMode</span><span data-if="python" style="display:none">closest_point_mode</span></code></i></a> determines how the closest
points are stored.  For <a href="#ClosestPointMode"><i><code><span data-if="hdevelop" style="display:inline">ClosestPointMode</span><span data-if="c" style="display:none">ClosestPointMode</span><span data-if="cpp" style="display:none">ClosestPointMode</span><span data-if="com" style="display:none">ClosestPointMode</span><span data-if="dotnet" style="display:none">closestPointMode</span><span data-if="python" style="display:none">closest_point_mode</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'absolute'</span><span data-if="c" style="display:none">"absolute"</span><span data-if="cpp" style="display:none">"absolute"</span><span data-if="com" style="display:none">"absolute"</span><span data-if="dotnet" style="display:none">"absolute"</span><span data-if="python" style="display:none">"absolute"</span></i>, absolute coordinates are stored in
<a href="#ClosestPoints"><i><code><span data-if="hdevelop" style="display:inline">ClosestPoints</span><span data-if="c" style="display:none">ClosestPoints</span><span data-if="cpp" style="display:none">ClosestPoints</span><span data-if="com" style="display:none">ClosestPoints</span><span data-if="dotnet" style="display:none">closestPoints</span><span data-if="python" style="display:none">closest_points</span></code></i></a>.  For <a href="#ClosestPointMode"><i><code><span data-if="hdevelop" style="display:inline">ClosestPointMode</span><span data-if="c" style="display:none">ClosestPointMode</span><span data-if="cpp" style="display:none">ClosestPointMode</span><span data-if="com" style="display:none">ClosestPointMode</span><span data-if="dotnet" style="display:none">closestPointMode</span><span data-if="python" style="display:none">closest_point_mode</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'relative'</span><span data-if="c" style="display:none">"relative"</span><span data-if="cpp" style="display:none">"relative"</span><span data-if="com" style="display:none">"relative"</span><span data-if="dotnet" style="display:none">"relative"</span><span data-if="python" style="display:none">"relative"</span></i>, the offset to the coordinate of the respective
pixel is stored in <a href="#ClosestPoints"><i><code><span data-if="hdevelop" style="display:inline">ClosestPoints</span><span data-if="c" style="display:none">ClosestPoints</span><span data-if="cpp" style="display:none">ClosestPoints</span><span data-if="com" style="display:none">ClosestPoints</span><span data-if="dotnet" style="display:none">closestPoints</span><span data-if="python" style="display:none">closest_points</span></code></i></a>.</p>
<h2 id="sec_attention">注意</h2>
<p>It should be noted that the closest points are usually not unique,
i.e., for each pixel in the image <a href="#Distances"><i><code><span data-if="hdevelop" style="display:inline">Distances</span><span data-if="c" style="display:none">Distances</span><span data-if="cpp" style="display:none">Distances</span><span data-if="com" style="display:none">Distances</span><span data-if="dotnet" style="display:none">distances</span><span data-if="python" style="display:none">distances</span></code></i></a>, there usually
exist several points on the outer border of the region that have the
respective distance to that pixel.  For example, all points on the
skeleton of the region in the chosen metric have the same distance
to at least two distinct points on the outer border of the region.
<code><span data-if="hdevelop" style="display:inline">closest_point_transform</span><span data-if="c" style="display:none">closest_point_transform</span><span data-if="cpp" style="display:none">ClosestPointTransform</span><span data-if="com" style="display:none">ClosestPointTransform</span><span data-if="dotnet" style="display:none">ClosestPointTransform</span><span data-if="python" style="display:none">closest_point_transform</span></code> returns one of these points that is
determined by the implementation of the algorithm.  In particular,
invariances with respect to rotation or mirroring of the region
should <em>not</em> be expected.
</p>
<p>Furthermore, it should be noted that for <a href="#Foreground"><i><code><span data-if="hdevelop" style="display:inline">Foreground</span><span data-if="c" style="display:none">Foreground</span><span data-if="cpp" style="display:none">Foreground</span><span data-if="com" style="display:none">Foreground</span><span data-if="dotnet" style="display:none">foreground</span><span data-if="python" style="display:none">foreground</span></code></i></a> =
<i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i>, point coordinates that lie outside the image
defined by <a href="#Width"><i><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></i></a> and <a href="#Height"><i><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></i></a> are returned if the
input region <a href="#Region"><i><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></i></a> touches the border of this image, since
in this case the outside border of the region lies one pixel outside
of the image.  If the returned coordinates should be used for a
direct access to an image, a suitable border treatment must be
implemented.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Region" class="parname"><b><code><span data-if="hdevelop" style="display:inline">区域</span><span data-if="c" style="display:none">区域</span><span data-if="cpp" style="display:none">区域</span><span data-if="com" style="display:none">区域</span><span data-if="dotnet" style="display:none">区域</span><span data-if="python" style="display:none">区域</span></code></b> (input_object)  </span><span>region(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HRegion.html">HRegion</a></span><span data-if="c" style="display:none">Hobject</span></span>
</div>
<p class="pardesc">Region for which the distance to the border is
computed.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Distances" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Distances</span><span data-if="c" style="display:none">Distances</span><span data-if="cpp" style="display:none">Distances</span><span data-if="com" style="display:none">Distances</span><span data-if="dotnet" style="display:none">distances</span><span data-if="python" style="display:none">distances</span></code></b> (output_object)  </span><span>image <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject *</span> (int4)</span>
</div>
<p class="pardesc">Image containing the distance information.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ClosestPoints" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ClosestPoints</span><span data-if="c" style="display:none">ClosestPoints</span><span data-if="cpp" style="display:none">ClosestPoints</span><span data-if="com" style="display:none">ClosestPoints</span><span data-if="dotnet" style="display:none">closestPoints</span><span data-if="python" style="display:none">closest_points</span></code></b> (output_object)  </span><span>image <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject *</span> (vector_field)</span>
</div>
<p class="pardesc">Image containing the coordinates of the closest points.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Metric" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Metric</span><span data-if="c" style="display:none">Metric</span><span data-if="cpp" style="display:none">Metric</span><span data-if="com" style="display:none">Metric</span><span data-if="dotnet" style="display:none">metric</span><span data-if="python" style="display:none">metric</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Type of metric to be used for the closest-point
transformation.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'city-block'</span>
    <span data-if="c" style="display:none">"city-block"</span>
    <span data-if="cpp" style="display:none">"city-block"</span>
    <span data-if="com" style="display:none">"city-block"</span>
    <span data-if="dotnet" style="display:none">"city-block"</span>
    <span data-if="python" style="display:none">"city-block"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'chamfer-3-4'</span><span data-if="c" style="display:none">"chamfer-3-4"</span><span data-if="cpp" style="display:none">"chamfer-3-4"</span><span data-if="com" style="display:none">"chamfer-3-4"</span><span data-if="dotnet" style="display:none">"chamfer-3-4"</span><span data-if="python" style="display:none">"chamfer-3-4"</span>, <span data-if="hdevelop" style="display:inline">'chamfer-3-4-unnormalized'</span><span data-if="c" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="cpp" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="com" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="dotnet" style="display:none">"chamfer-3-4-unnormalized"</span><span data-if="python" style="display:none">"chamfer-3-4-unnormalized"</span>, <span data-if="hdevelop" style="display:inline">'chessboard'</span><span data-if="c" style="display:none">"chessboard"</span><span data-if="cpp" style="display:none">"chessboard"</span><span data-if="com" style="display:none">"chessboard"</span><span data-if="dotnet" style="display:none">"chessboard"</span><span data-if="python" style="display:none">"chessboard"</span>, <span data-if="hdevelop" style="display:inline">'city-block'</span><span data-if="c" style="display:none">"city-block"</span><span data-if="cpp" style="display:none">"city-block"</span><span data-if="com" style="display:none">"city-block"</span><span data-if="dotnet" style="display:none">"city-block"</span><span data-if="python" style="display:none">"city-block"</span>, <span data-if="hdevelop" style="display:inline">'euclidean'</span><span data-if="c" style="display:none">"euclidean"</span><span data-if="cpp" style="display:none">"euclidean"</span><span data-if="com" style="display:none">"euclidean"</span><span data-if="dotnet" style="display:none">"euclidean"</span><span data-if="python" style="display:none">"euclidean"</span>, <span data-if="hdevelop" style="display:inline">'octagonal'</span><span data-if="c" style="display:none">"octagonal"</span><span data-if="cpp" style="display:none">"octagonal"</span><span data-if="com" style="display:none">"octagonal"</span><span data-if="dotnet" style="display:none">"octagonal"</span><span data-if="python" style="display:none">"octagonal"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Foreground" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Foreground</span><span data-if="c" style="display:none">Foreground</span><span data-if="cpp" style="display:none">Foreground</span><span data-if="com" style="display:none">Foreground</span><span data-if="dotnet" style="display:none">foreground</span><span data-if="python" style="display:none">foreground</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Compute the distance for pixels inside (<i><span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></i>)
or outside (<i><span data-if="hdevelop" style="display:inline">'false'</span><span data-if="c" style="display:none">"false"</span><span data-if="cpp" style="display:none">"false"</span><span data-if="com" style="display:none">"false"</span><span data-if="dotnet" style="display:none">"false"</span><span data-if="python" style="display:none">"false"</span></i>) the input region.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'true'</span>
    <span data-if="c" style="display:none">"true"</span>
    <span data-if="cpp" style="display:none">"true"</span>
    <span data-if="com" style="display:none">"true"</span>
    <span data-if="dotnet" style="display:none">"true"</span>
    <span data-if="python" style="display:none">"true"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'false'</span><span data-if="c" style="display:none">"false"</span><span data-if="cpp" style="display:none">"false"</span><span data-if="com" style="display:none">"false"</span><span data-if="dotnet" style="display:none">"false"</span><span data-if="python" style="display:none">"false"</span>, <span data-if="hdevelop" style="display:inline">'true'</span><span data-if="c" style="display:none">"true"</span><span data-if="cpp" style="display:none">"true"</span><span data-if="com" style="display:none">"true"</span><span data-if="dotnet" style="display:none">"true"</span><span data-if="python" style="display:none">"true"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="ClosestPointMode" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ClosestPointMode</span><span data-if="c" style="display:none">ClosestPointMode</span><span data-if="cpp" style="display:none">ClosestPointMode</span><span data-if="com" style="display:none">ClosestPointMode</span><span data-if="dotnet" style="display:none">closestPointMode</span><span data-if="python" style="display:none">closest_point_mode</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Mode in which the coordinates of the closest points
are returned.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'absolute'</span>
    <span data-if="c" style="display:none">"absolute"</span>
    <span data-if="cpp" style="display:none">"absolute"</span>
    <span data-if="com" style="display:none">"absolute"</span>
    <span data-if="dotnet" style="display:none">"absolute"</span>
    <span data-if="python" style="display:none">"absolute"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'absolute'</span><span data-if="c" style="display:none">"absolute"</span><span data-if="cpp" style="display:none">"absolute"</span><span data-if="com" style="display:none">"absolute"</span><span data-if="dotnet" style="display:none">"absolute"</span><span data-if="python" style="display:none">"absolute"</span>, <span data-if="hdevelop" style="display:inline">'relative'</span><span data-if="c" style="display:none">"relative"</span><span data-if="cpp" style="display:none">"relative"</span><span data-if="com" style="display:none">"relative"</span><span data-if="dotnet" style="display:none">"relative"</span><span data-if="python" style="display:none">"relative"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Width" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></b> (input_control)  </span><span>extent.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Width of the output images.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>640</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>160, 192, 320, 384, 640, 768</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">Width</span>
    <span data-if="c" style="display:none">Width</span>
    <span data-if="cpp" style="display:none">Width</span>
    <span data-if="com" style="display:none">Width</span>
    <span data-if="dotnet" style="display:none">width</span>
    <span data-if="python" style="display:none">width</span>
    </code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Height" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></b> (input_control)  </span><span>extent.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Height of the output images.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>480</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>120, 144, 240, 288, 480, 576</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">Height</span>
    <span data-if="c" style="display:none">Height</span>
    <span data-if="cpp" style="display:none">Height</span>
    <span data-if="com" style="display:none">Height</span>
    <span data-if="dotnet" style="display:none">height</span>
    <span data-if="python" style="display:none">height</span>
    </code></p>
</div>
<h2 id="sec_complexity">Complexity</h2>
<p>The runtime complexity is O(<a href="#Width"><i><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></i></a>*<a href="#Height"><i><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></i></a>).</p>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">closest_point_transform</span><span data-if="c" style="display:none">closest_point_transform</span><span data-if="cpp" style="display:none">ClosestPointTransform</span><span data-if="com" style="display:none">ClosestPointTransform</span><span data-if="dotnet" style="display:none">ClosestPointTransform</span><span data-if="python" style="display:none">closest_point_transform</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if all parameters are
correct.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="threshold.html"><span data-if="hdevelop" style="display:inline">threshold</span><span data-if="c" style="display:none">threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">Threshold</span><span data-if="python" style="display:none">threshold</span></a></code>, 
<code><a href="dyn_threshold.html"><span data-if="hdevelop" style="display:inline">dyn_threshold</span><span data-if="c" style="display:none">dyn_threshold</span><span data-if="cpp" style="display:none">DynThreshold</span><span data-if="com" style="display:none">DynThreshold</span><span data-if="dotnet" style="display:none">DynThreshold</span><span data-if="python" style="display:none">dyn_threshold</span></a></code>, 
<code><a href="regiongrowing.html"><span data-if="hdevelop" style="display:inline">regiongrowing</span><span data-if="c" style="display:none">regiongrowing</span><span data-if="cpp" style="display:none">Regiongrowing</span><span data-if="com" style="display:none">Regiongrowing</span><span data-if="dotnet" style="display:none">Regiongrowing</span><span data-if="python" style="display:none">regiongrowing</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="threshold.html"><span data-if="hdevelop" style="display:inline">threshold</span><span data-if="c" style="display:none">threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">Threshold</span><span data-if="python" style="display:none">threshold</span></a></code>, 
<code><a href="vector_field_to_real.html"><span data-if="hdevelop" style="display:inline">vector_field_to_real</span><span data-if="c" style="display:none">vector_field_to_real</span><span data-if="cpp" style="display:none">VectorFieldToReal</span><span data-if="com" style="display:none">VectorFieldToReal</span><span data-if="dotnet" style="display:none">VectorFieldToReal</span><span data-if="python" style="display:none">vector_field_to_real</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="distance_transform.html"><span data-if="hdevelop" style="display:inline">distance_transform</span><span data-if="c" style="display:none">distance_transform</span><span data-if="cpp" style="display:none">DistanceTransform</span><span data-if="com" style="display:none">DistanceTransform</span><span data-if="dotnet" style="display:none">DistanceTransform</span><span data-if="python" style="display:none">distance_transform</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="skeleton.html"><span data-if="hdevelop" style="display:inline">skeleton</span><span data-if="c" style="display:none">skeleton</span><span data-if="cpp" style="display:none">Skeleton</span><span data-if="com" style="display:none">Skeleton</span><span data-if="dotnet" style="display:none">Skeleton</span><span data-if="python" style="display:none">skeleton</span></a></code>
</p>
<h2 id="sec_references">References</h2>
<p>

Y. Ge, C.R. Maurer, Jr., J.M. Fitzpatrick: “Surface-based 3-D image
registration using the Iterative Closest Point algorithm with a
closest point transform”; in: “Medical Imaging 1996: Image
Processing”, M.H. Loew, K.M. Hanson, Editors, Proc. SPIE 2710,
pages 358--367, 1996.
<br>
P. Soille: “Morphological Image Analysis, Principles and
Applications”; Springer Verlag Berlin Heidelberg New York, 1999.
<br>
G. Borgefors: “Distance Transformations in Arbitrary Dimensions”;
Computer Vision, Graphics, and Image Processing, Vol. 27, pages
321--345, 1984.
<br>
P.E. Danielsson: “Euclidean Distance Mapping”; Computer Graphics
and Image Processing, Vol. 14, pages 227--248, 1980.
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
